home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / PROGRAM / CWL2A_1.ARJ / README < prev    next >
Text File  |  1991-11-17  |  19KB  |  479 lines
  1.                           THE C WINDOW LIBRARY
  2.  
  3.  
  4.                     (c) Copyright P. A. McKenzie 1990, 1991
  5.                             All Rights Reserved
  6.  
  7.  
  8.                               Version 2.0a
  9.  
  10.  
  11.  
  12.  
  13.               Author:            P.A. McKenzie
  14.                                  CitySoft Software
  15.                                  100-3 Alcott Place
  16.                                  Bronx, N.Y. 10475
  17.  
  18.               Compuserve            : [72537,17]
  19.  
  20.               Bix                   : "pmckenzie"
  21.  
  22.               CitySoft Software BBS : (212) 671 - 4379
  23.               (BBS operational on April 1st, 1991)
  24.  
  25.  
  26.   The C Window Library Copyright 1990,1991 P. A. Mckenzie.
  27.   All Rights Reserved.
  28.  
  29.    PC-DOS, PC, PC XT, PC AT, and PS/2 are trademarks of IBM
  30.    Corporation.
  31.    MS-DOS, Microsoft C, and Quick C are trademarks of Microsoft Corporation.
  32.    Turbo C and other mentioned Borland products are trademarks of Borland
  33.    International Inc.
  34.    Power C is a trademark of Mix Software.
  35.    Zortech C++ is a trademark of Zortech Limited.
  36.    Hercules is a trademark of the Hercules Corporation.
  37.    1-2-3 is a trademark of Lotus Development Corporation.
  38.    DESQview is a trademark of Quarterdeck Office Systems.
  39.  
  40.    All others that have gone unmentioned are copyrights of their respective
  41.    companies.
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                      INTRODUCTION TO THE C WINDOW LIBRARY
  71.  
  72.   Welcome to The C Window Library!  The C Window Library is an add-on C library
  73.   that will add powerful text windows, virtual window, menu, mouse support,
  74.   and other miscellaneous video goodies to your C programs.  Included in the
  75.   shareware package is a full 300+ page manual with descriptions of all
  76.   functions and examples of every aspect of The C Window Library.  Currently
  77.   the library supports the following compilers:
  78.  
  79.     Microsoft C Ver 5.1 and above
  80.     Quick C Ver. 2.0 and above
  81.     Turbo C Ver. 2.0 and above, Turbo C++ Ver 1.0 and above, Borland C++.
  82.     Power C Ver. 2.1 and above
  83.     Zortech C++ Ver. 2.1 and above
  84.  
  85.   The C Window Library is written in 90% C, with the other 10% in assembly
  86.   language.
  87.  
  88.   The goal of The C Window Library is to get the library up to par with the
  89.   other expensive C libraries around, without draining your wallet.  If you have
  90.   used other shareware window libraries, you will be in for a pleasant surprise
  91.   with The C Window Library.  The features available with The C Window Library
  92.   are very extensive, without locking you into rigid restrictions that other
  93.   window libraries would give you.
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.                            REGISTRATION INFORMATION
  102.  
  103.   When you register your version of The C Window Library, you will receive the
  104.   following:
  105.  
  106.   a) free update to the next major revision of The C Window Library.
  107.  
  108.   b) full source code to the window library and all memory models.
  109.  
  110.   If you register your version of The C Window Library before March 1, 1992
  111.   you will receive The C Data Forms Library and source code absolutely free.
  112.   After this date, the library will cost an additional $25.
  113.  
  114.   Also available will be The C Mouse Library.  This library allows you to
  115.   create applications that are mouse event driven.  Read the ORDER.FRM file
  116.   for more information on this great add-on to The C Window Library.
  117.  
  118.   To register The C Window Library, as well as ordering The Data Forms and
  119.   Mouse Libraries, you should print the file ORDER.FRM.   Do this by issuing
  120.   the command on the DOS command line:
  121.  
  122.                       TYPE ORDER.FRM > PRN
  123.  
  124.   This file contains the order form as well as additional information on the
  125.   Data Forms and Mouse libraries.
  126.  
  127.   Since there are slight changes in the source code due to bug fixes, minor
  128.   enhancements, etc., customers who have paid the $50 registration fee will
  129.   receive updated source code no more than four times per calendar year.
  130.   However, any major revision done to The C Window Library will entitle
  131.   registered users to the source code immediately.
  132.  
  133.   Remember that the shareware version of the library IS NOT CRIPPLED.  You can
  134.   create real applications right away with the shareware version, and you get
  135.   the full documentation.  Therefore I am trusting you (the user) to send in
  136.   the registration fee (see below for a description of shareware and what the
  137.   responsibilities of the user of shareware products are).  I am sure that you
  138.   want to reward fellow programmers on what they have developed.
  139.  
  140.   If you want to develop data entry forms with The C Window Library, it is wise
  141.   to get The C Data Forms Library.  This library is a set of routines that
  142.   allow you to set up data entry forms that have many capabilities.  See the
  143.   offer above for availability.
  144.  
  145.  
  146.                            TECHNICAL SUPPORT
  147.  
  148.   Technical support is provided for registered as well as non-registered users
  149.   of The C Window Library.  Since The C Window Library is currently a shareware
  150.   product, technical support will be provided for persons who are in the
  151.   evaluation stages of the product.  However, for any questions concerning
  152.   internals of The C Window Library where the source code must be present to
  153.   such persons asking technical assistance, only registered users will get
  154.   technical support.
  155.  
  156.   You can get technical support in four ways:
  157.  
  158.   1) E-Mail to Compuserve [72537,17]
  159.  
  160.   2) E-Mail on BIX (Byte Information Exchange) to "pmckenzie"
  161.  
  162.   3) E-Mail to the CitySoft Software bulletin board.  The phone number is
  163.      (212) 671 - 4379.
  164.  
  165.   4) by mail
  166.  
  167.  
  168.   Responses to questions on BIX or CompuServe will be done on a daily basis.
  169.   If responding by Compuserve, or BIX, leave your name, registration number
  170.   if necessary, compiler and version, version of The C Window Library, and
  171.   Compuserve or BIX number.  If responding by mail, please leave name,
  172.   registration number if necessary, compiler and version, the version of The C
  173.   Window Library, and a phone number where you can be reached during the times
  174.   of 10:00 AM and 6:00 PM Eastern Time.
  175.  
  176.   You can also log into the CitySoft Software BBS at (212) 671 - 4379.  You will
  177.   have immediate access to the newest shareware version of the library.  If
  178.   you register your shareware version, you will be given access to download the
  179.   registered version of the library.  You should log on using the following
  180.   parameters:
  181.                a)   1200 or 2400 baud
  182.                b)   8 data bits
  183.                c)   1 stop bits
  184.                d)   no parity
  185.  
  186.  
  187.  
  188.  
  189.                             DEFINITION OF SHAREWARE
  190.  
  191.   Shareware distribution gives users a chance to try software before buying it.
  192.   If you try a Shareware program and continue using it, you are expected to
  193.   register.  Individual programs differ on details -- some request registration
  194.   while others require it, some specify a maximum trial period. With
  195.   registration, you can continue using the software, full source code to the C
  196.   Window Library, and free upgrades.
  197.  
  198.   Copyright laws apply to both Shareware and commercial software, and the
  199.   copyright holder retains all rights, with a few specific exceptions as stated
  200.   below. Shareware authors are accomplished programmers, just like commercial
  201.   authors, and the programs are of comparable quality. (In both cases, there are
  202.   good programs and bad ones!) The main difference is in the method of
  203.   distribution. The author specifically grants the right to copy and distribute
  204.   the software, either to all and sundry or to a specific group. For example,
  205.   some authors require written permission before a commercial disk vendor may
  206.   copy their Shareware.
  207.   Shareware is a distribution method, not a type of software. You should find
  208.   software that suits your needs and pocketbook, whether it's commercial or
  209.   Shareware. The Shareware system makes fitting your needs easier, because you
  210.   can try before you buy.  And because the overhead is low, prices are low also.
  211.   Shareware has the ultimate money-back guarantee -- if you don't use the
  212.   product, you don't pay for it.
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.                             DISCLAIMER - AGREEMENT
  246.  
  247.   Users of The C Window Library must accept this disclaimer of warranty:
  248.  
  249.   "The C Window Library is supplied as is.  The author disclaims all warranties,
  250.   expressed or implied, including, without limitation, the warranties of
  251.   merchantability and of fitness for any purpose.  The author assumes no
  252.   liability for damages, direct or consequential, which may result from the
  253.   use of The C Window Library."
  254.  
  255.   The C Window Library is a "shareware program" and is provided at no charge to
  256.   the user for evaluation.  Feel free to share it with your friends, but please
  257.   do not give it away altered or as part of another system.  The essence of
  258.   "user-supported" software is to provide personal computer users with quality
  259.   software without high prices, and yet to provide incentive for programmers to
  260.   continue to develop new products.  If you find this program useful and find
  261.   that you are using The C Window Library and continue to use The C Window
  262.   Library after a reasonable trial period, you must make a registration payment
  263.   of $50 to CitySoft Software.  The $50 registration fee will license one copy
  264.   for use on any one computer at any one time.  You must treat this software
  265.   just like a book.  An example is that this software may be used by any number
  266.   of people and may be freely moved from one computer location to another, so
  267.   long as there is no possibility of it being used at one location while it's
  268.   being used at another.  Just as a book cannot be read by two different
  269.   persons at the same time.
  270.  
  271.   Commercial users of The C Window Library must register and pay for their
  272.   copies of The C Window Library within 30 days of first use or their license is
  273.   withdrawn.  Site-License arrangements may be made by contacting CitySoft
  274.   Software.
  275.  
  276.   Anyone distributing The C Window Library for any kind of remuneration must
  277.   first contact CitySoft Software at the address above for authorization.  This
  278.   authorization will be automatically granted to distributors recognized by the
  279.   (ASP) as adhering to its guidelines for shareware distributors, and such
  280.   distributors may begin offering The C Window Library immediately (However
  281.   CitySoft Software must still be advised so that the distributor can be kept
  282.   up-to-date with the latest version of The C Window Library.).
  283.  
  284.   You are encouraged to pass a copy of The C Window Library along to your
  285.   friends for evaluation.  Please encourage them to register their copy if they
  286.   find that they can use it.  All registered users will receive a copy of the
  287.   latest version of the The C Window Library system.
  288.  
  289.   There are no royalties on any commercial or non-commercial application that
  290.   you develop.  However, CitySoft Software strictly prohibits you from creating
  291.   an application that is similar in design to The C Window Library i.e. another
  292.   window library.
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.                           USING THE C WINDOW LIBRARY
  300.  
  301.   If you are not familiar with using third party libraries and how to link
  302.   the library with the rest of your code, please consult the various
  303.   documentation supplied with the compiler that you are working with.  This is
  304.   not a full tutorial on how to link third party libraries.
  305.  
  306.   The default word/byte alignment scheme was used when compiling all the
  307.   libraries.  In other words, all modules were compiled without the use of the
  308.   word/byte alignment switch being used.
  309.  
  310.  
  311.   Header Files and Library Files
  312.   ------------------------------
  313.  
  314.   The following library files are provided in the shareware version:
  315.  
  316.      MSWINM.LIB -- Medium memory model version for Microsoft C 5.1 and above,
  317.                    and Quick C Version 1.0 and above.
  318.  
  319.      PCWINM.MIX -- Medium memory model version for Power C Version 2.0 and
  320.                    above.
  321.  
  322.      TCWINM.LIB -- Medium memory model version for Turbo C Version 1.5 and
  323.                    above or Turbo C++ Version 1.0 and above.
  324.  
  325.      ZCWINM.LIB -- Medium memory model version for Zortech C++ Version 2.0 and
  326.                    above.
  327.  
  328.  
  329.   The following libraries are needed to implement the mouse in The C Window
  330.   Library:
  331.  
  332.      MSMOUSEM.LIB -- Medium memory model for Microsoft C 5.1
  333.                      and above, and Quick C Version 1.0 and above.
  334.  
  335.      PCMOUSEM.MIX -- Medium memory model version for Power C Version 2.0 and
  336.                      above.
  337.  
  338.      TCMOUSEM.LIB -- Medium memory model version for Turbo C Version 1.5 and
  339.                      above or Turbo C++ Version 1.0 and above.
  340.  
  341.      ZCMOUSEM.LIB -- Medium memory model version for Zortech C++ Version 2.0 and
  342.                      above.
  343.  
  344.   The mouse libraries defined above are subsets of The C Mouse Library.  To
  345.   order the full version of The C Mouse Library, read the ORDER.FRM file.
  346.  
  347.  
  348.   The header files included are the following:
  349.  
  350.      BSTRING.H
  351.      CURSOR.H
  352.      EFFECTS.H
  353.      KEY.H
  354.      KEYCODES.H
  355.      MENU.H
  356.      MISC.H
  357.      PROTO.H
  358.      USCORE.H
  359.      VIDSYS.H
  360.      WERROR.H
  361.      WINDOW.H
  362.      WSTRUCT.H
  363.      CWLMOUSE.H
  364.  
  365.  
  366.  
  367.   Microsoft / Quick C
  368.   -------------------
  369.  
  370.   When compiling your programs, you must make sure that the constant MSC is
  371.   defined.  An example of how you would do this as follows:
  372.  
  373.   cl -Ax -DMSC -Ihfiles prog1.c prog2.c /link mswinx.lib msmousex.lib
  374.  
  375.   the -Ax is the model used for compilation.  The x stands for either S for
  376.   small, M for medium, C for compact, or L for large.  The -D option defines a
  377.   constant, which in this case is MSC.  You must use the -D switch with MSC as
  378.   the constant.  If not, you will get either syntax errors, link errors, or
  379.   runtime errors.  The -I option tells the compiler that the .h files are
  380.   located in a directory on the default drive called hfiles.  The /link option
  381.   links the resulting object files (prog1.obj and prog2.obj) with the The C
  382.   Window Library file mswinx.lib, where x stands for S, M, C, or L.  The mouse
  383.   library msmousex.lib, where x stands for S, M, C, or L, is necessary only if
  384.   you plan to use the mouse in your application.
  385.  
  386.   The other method is to create a make file.  If you are using the integrated
  387.   environment of Quick C or using the Programmers Work Bench (PWB) for
  388.   Microsoft C 6.0, you can create your make files by selecting the files you
  389.   want to compile, and the libraries you want to link with and letting these
  390.   integrated environments create the make file automatically.  If you are more
  391.   advanced you can create your make files by yourself without the aid of these
  392.   programs.  Consult the documentation for more information on make files.
  393.  
  394.  
  395.  
  396.   Turbo C and TurboC++
  397.   --------------------
  398.  
  399.   If you will use the integrated environment, you must create a project file.
  400.   This project file specifies the source code modules, object code modules, and
  401.   libraries that will be linked in to produce an executable file.  If you use
  402.   the Turbo C Ver 2.0 integrated environment, you must edit this file yourself.
  403.   If you use the Turbo C++ integrated environment, use the automatic Project
  404.   File creator.
  405.  
  406.   You can also use make files to link in your program.  Make sure that the
  407.   desired library from The C Window Toolkit is specified.
  408.  
  409.   You can also use the TCC.EXE command line compiler with the desired library
  410.   specified on the command line.  Consult the Turbo C documentation on using
  411.   make files and using the integrated environment.
  412.  
  413.   The default structure alignment was used to compile the libraries, which
  414.   is byte alignment.
  415.  
  416.   An example of using the TCC.EXE command line is as follows:
  417.  
  418.        tcc -mm -G -r -ihfiles prog1.c tcwinm.lib tcmousem.lib
  419.  
  420.   The following command line uses -mm for the medium memory model, -G to
  421.   optimize for speed, -r for usage of register variables, and -i to tell the
  422.   compiler that the header files are located in a directory on the default
  423.   drive called hfiles. The mouse library, tcmousem.lib, is necessary only if
  424.   you plan to use the mouse in your application.
  425.  
  426.  
  427.  
  428.   Power C
  429.   -------
  430.  
  431.   If you are using the POWER C compiler from Mix Software, you must define
  432.   the constant POWERC on the command line.
  433.  
  434.                      pc -dPOWERC -mm -ihfiles prog1.c
  435.  
  436.   You must have the constant POWERC defined on the pc.exe command line using
  437.   the -d option.  If not, you may get syntax, link, or runtime errors.
  438.   The -mm tells the compiler to use the medium memory model, and the -i option
  439.   tells the compiler that there are .h files located on the default drive in
  440.   the directory hfiles.
  441.  
  442.   Depending on the number of windows your application will use and the code
  443.   size, you will have to use different stack and heap options in the Power C
  444.   linker, pcl.  An example of this is as follows:
  445.  
  446.                      pcl [20k,30k,200k] a;pcwinm;pcmousem
  447.  
  448.   This will link the object file a.mix with the pcwinm.mix library with 20k of
  449.   stack space, 30k of near heap space, and 200k of far heap space.  If your
  450.   application has many or very large virtual windows, you should use the maximum
  451.   far heap space allowable.  If your program has many windows, you should
  452.   increase the near heap space parameter, or use the pcwinl.mix library and
  453.   increase the far heap space parameter.  If your program has recursive or
  454.   deeply nested functions, you should increase the stack parameter.  However the
  455.   stack and near heap space cannot exceed 64k.  This includes global and static
  456.   declarations in the program.  The mouse library, pcmousem, is necessary
  457.   only if you plan to use the mouse in your application.
  458.  
  459.  
  460.   Zortech C++
  461.   -----------
  462.  
  463.   If you are using the Zortech C++ compiler, you should use the following
  464.   options when compiling your program with The C Window Library:
  465.  
  466.               ztc -o -b -p -mm prog1.c zcwinm.lib zcmousem.lib
  467.  
  468.   The -o option turns on the global optimizer.  The -b option lets ztc know to
  469.   handle large programs.  The -p turns off autoprotyping.  The -mm option lets
  470.   the compiler use the medium memory model.  The programs prog1.c is compiled
  471.   using these options and then linked with the medium memory model of The C
  472.   Window Library's Zortech version, namely zcwinm.lib.
  473.  
  474.   The mouse library, zcmousem.lib, is necessary only if you plan to use the
  475.   mouse in your application.
  476.  
  477.  
  478.  
  479.